home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / yrndl13.zip / readme.1st < prev    next >
Text File  |  1996-07-20  |  9KB  |  216 lines
  1. README.1ST for YRNDL13.ZIP    20 Jul 1996
  2. [Excerpted from YD.DOC]
  3. (c) 1996 by Jerry Levy
  4. Jerry Levy    Marblehead, MA USA
  5. jlevy@ibm.net
  6.  
  7. ABOUT THIS VERSION:  This is version 1.3(beta) of YARNDIAL and
  8. represents a major upgrade.  An installer has been added which supports
  9. fully use of IBM/Advantis' IAK Dialer (for Advantis network only), the
  10. IBM SLIPPM dialer (the Dial-Other-Internet-Providers utility), and
  11. PPP.EXE and SLIP.EXE dialup strings.  It supports use of other dialers
  12. such as the IN-JOY Dialer via dialup strings and has IN-JOY support
  13. "built-in".
  14.  
  15. I plan to issue the final version by October 1, 1996.  This version is
  16. in pretty good shape and the only reason for keeping it beta is that I
  17. hope to enhance third-party dialer support.
  18.  
  19. This program is and will stay freeware.
  20.  
  21. For use of third-party dialers such as IN-JOY, YARNDIAL expects
  22. you to go through the motions of setting up SLIPPM, and we use
  23. the SLIPPM parameter files as repositories for parameters that
  24. YARNDIAL needs in order to run.  SLIPPM is a fine utility, and in
  25. most instances where you are connecting to a provider other than
  26. Advantis and you need to make a SLIP or PPP connection, it, used
  27. alone or with add-on script packages such as PPPDIAL28, is a fine
  28. utility.  
  29.  
  30. I am committed to adding and improving support of third-party
  31. dialers provided I can obtain a copy to work with and the interface
  32. is not obscure.  Contact me if I do not support your pet dialer.
  33.  
  34.  
  35. INSTALLATION FOR THE IMPATIENT USER (ASSUMES YARN AND SOUPER 
  36. ARE INSTALLED AND THEY WORK)
  37. 1.    First unzip YRNDL13.ZIP into a temporary folder.  You 
  38. have probably done that if you are reading this.
  39.  
  40. The archive is YRNDL13.ZIP
  41.  
  42. Files in the archive are
  43.     FILE.DIZ        Zipfile description
  44.     README.1ST        This file, a lot shorter than YD.DOC
  45.     YD.DOC        Documentation for YARNDIAL
  46.     YDINSTL.CMD        The installer
  47.     YARNDIAL.CMD    
  48.     GO.EXE        From GO_15.ZIP, needed by YARNDIAL
  49.     GO_15.ZIP        Please open at your leisure, read     
  50.                 the documentation and send Carsten     
  51.                 his postcard.
  52.     an \ICONS\ subdirectory containing all of the icons 
  53.     needed
  54.  
  55. If you unzipped YRNDL13.ZIP with PkZip without using the -d 
  56. option, you will not have a subdirectory named ICONS.  That 
  57. will not interfere with installation.  YDINSTL will manage 
  58. to find the icons.
  59.  
  60. 2.    Double-click on YDINSTL.CMD and follow the 
  61. instructions in screen prompts.
  62.  
  63.  
  64. WHAT IS YARNDIAL?
  65. YARNDIAL.CMD is a menu-driven front end for C.T. Huang's 
  66. OS/2 Souper and Yarn off-line News and Mail 
  67. reader/management programs.  YARNDIAL is a ReXX utility 
  68. running under OS/2 Warp.  It is designed to automate the 
  69. steps needed to retrieve and send news articles and mail and 
  70. while doing so to provide a more versatile, friendlier 
  71. interface for users than could be accomplished using 
  72. ordinary batch files.
  73.  
  74. YARNDIAL v. 1.3 and its installer (YDINSTL.CMD) should work 
  75. with any version of OS/2 Warp.  ReXX must  installed for 
  76. YARNDIAL and its installer to run.  Yarn and Souper must 
  77. also be correctly installed since YARNDIAL functions as a 
  78. front end for Souper and interfaces with Yarn.
  79.  
  80. YARNDIAL's opening menu allows you seven choices:
  81.  
  82. 1  Only import Mail
  83. 2  Only import News Articles
  84. 3  Only import, but both Mail AND News
  85. 4  Only export (send Mail, Posts, Replies, and Follow-ups)
  86. 5  Everything: Get mail and news AND send Posts, Replies, 
  87.    and Follow-ups
  88. 6  Complete an interrupted importation of mail/news
  89.    or rebuild a corrupted YARN history file
  90. 7  Souper options:  one-time-only changes in how souper 
  91.    runs:
  92.       Catchup on News
  93.       Maximum News Packet Size
  94.       Do not retrieve newsgroup articles Longer than set 
  95.          number of lines
  96.       Read-only for Mail: Don't empty POP3 Mailbox
  97.  
  98.  
  99. KEY FEATURES
  100. o  Automatic dialup, connection, retrieval and sending of 
  101. news and/or mail, and signoff
  102.  
  103. o Ability under certain circumstances to operate for a SLIP 
  104. or PPP connection that happens to be established to a 
  105. provider
  106.  
  107. o  Ability to use a variety of dialup and connect options.    
  108. Supported are: the IBM/Advantis IAK Dialer,  IBM's Dial-
  109. Other-Internet-Providers utility (SLIPPM.EXE),  PPP.EXE and 
  110. SLIP.EXE dialup strings, and the IN-JOY dialer (only in-joy 
  111. v. 09 tested so far)
  112.  
  113. o  Menu-driven, for convenient selection of tasks
  114.  
  115. o  Ability to choose/change a limited number of Souper 
  116. command-line options (menu, during install)
  117.  
  118. o  Ability to choose/change some Souper command-line options 
  119. (menu, when running YARNDIAL)
  120.  
  121. o  A YARNDIAL menu item which allows you to complete an 
  122. importation of news or mail which had been interrupted,  and 
  123. to call up the Yarn utility REBUILD to restore damaged Yarn 
  124. spool and history files  (You don't need to understand this:  
  125. if you were downloading news and mail and it never showed 
  126. up, or your machine quit in the middle, or the lights went 
  127. out, maybe this will provide a fix)
  128.  
  129. o  YDINSTL.CMD provides a near-automated (prompted) 
  130. installation process if you already have installed Yarn and 
  131. Souper and they work
  132.  
  133. o  Ability of YARNDIAL to grab and use an existing SLIP or 
  134. PPP connection, or an existing PPP0 or SL0 interface.  This 
  135. has only been tested with connections initiated by 
  136. SLIPPM.EXE (includes SLIP.EXE and PPP.EXE), a connection 
  137. established by the IBM/Advantis IAK Dialer, or one 
  138. established by the IN-JOY dialer.
  139.  
  140. o  Some ability exists to discriminate if the connection 
  141. that is up is the correct connection for the particular user 
  142. for which YARNDIAL was installed.  This presently only 
  143. partially applies to the IN-JOY dialer.  I hope through 
  144. communication with the author of IN-JOY to work out details 
  145. for improved validation procedures.
  146.  
  147. o  Ability when you run YARNDIAL to select read-only for 
  148. mail retrieval (doesn't empty your POP3 mailbox).  I did not 
  149. extend this to read-only for news retrieval (i.e., to 
  150. prevent your NEWSRC file from updating).  You can edit the 
  151. Souper parameters in YD_PARMS.DAT file following 
  152. installation to achieve this end (add -r to the 
  153. getnews_xtra_options element).
  154.  
  155. o  Ability when you run YARNDIAL to do catchup on news.  
  156. Catchup marks as read all but some number you specify of 
  157. unread articles in each news group.
  158.  
  159. o  Among the Souper command-line options you can choose when 
  160. you run YDINSTL.CMD or at runtime when YARNDIAL is executed 
  161. are:
  162.       Set maximum size of the news packet you can download 
  163.       in a single session
  164. and    
  165.       Limit retrieval of news 
  166.       articles to those with no more than some maximum 
  167.       number you set of lines in the body of the article.
  168.  
  169. ======================
  170. COPYRIGHT NOTICE AND DISCLAIMERS
  171.     YDINSTL.CMD is Copyright 1996 by Jerry Levy
  172.        (all rights reserved)
  173.     YARNDIAL.CMD is Copyright 1995 and 1996 by Jerry Levy 
  174.         (all rights reserved)
  175. These are provided as-is and without charge, with no 
  176. warranty expressed or implied as to merchantability or 
  177. fitness for any particular purpose.  All responsibility for 
  178. any and all incidental and consequential damages is 
  179. disclaimed.  These programs and associated text files are 
  180. freeware.  They may be distributed without restriction 
  181. providing: (1) this notice and disclaimer remain intact, (2) 
  182. all programs and files are included and unchanged, and (3) 
  183. they are distributed either in the original .zip archive or 
  184. the archive after being unzipped into a folder or onto a 
  185. disk or other medium.  Use of either or both of these 
  186. programs constitutes acceptance of these terms by all users.
  187.  
  188. GO.EXE and GO_15.ZIP are  (c) 1993-95 by Carsten Wimmer and 
  189. are included with permission.
  190. YARN.ICO is (c) by Chin Huang and is included with 
  191. permission.
  192.  
  193. PASSWORDS - DISCLAIMER
  194. Some passwords are extracted from dialer setup files, and 
  195. while installing for use of the IBM/Advantis IAK Dialer, 
  196. we prompt for the Advantis password.  To keep these 
  197. passwords free from the casual eye, we scramble them before 
  198. they are written to YD_PARMS.DAT.  YARNDIAL unscrambles them 
  199. to use them.  Bear in mind that this is very low-tech 
  200. password protection designed only to discourage the 
  201. occa